home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 051-060 / amok53 / oberon2.0 / odebug.liesmich / odebug.liesmich
Text File  |  1993-11-04  |  7KB  |  219 lines
  1. Der Debugger ODebug
  2.  
  3. Dieser Runtime-Source-Level-Debugger ist ein nützliches Werkzeug beim
  4. Entwickeln von Programmen mit dem Amiga Oberon System. Er verschafft
  5. Anfängern Einblicke in den Ablauf von Programmen und ist für fortge-
  6. schrittene Software-Entwickler unverzichtbar.
  7.  
  8. Um ODebug verwenden zu können, ist Amiga Oberon V2.0 nötig. Sollten
  9. Sie diese Version noch nicht besitzen, können Sie das Update günstig
  10. bei der A+L AG beziehen.
  11.  
  12. Hardwareanforderungen:
  13.  
  14. Um sinnvoll mit ODebug arbeiten zu können, sollte man einen Amiga mit
  15. mindestens 1 MByte freiem Speicher und 2 Diskettenlaufwerken besitzen.
  16.  
  17. Start des Debuggers:
  18.  
  19. Alle Module eines Programms, die eventuell fehlerhaft sind und daher im
  20. Debugger angezeigt werden sollen, müssen zunächst mit der Compileroption
  21. '-g' compiliert werden. Wird vom Editor OEd aus compiliert, muß um Menü
  22. Options der Menüpunkt Debug angewählt sein. Bei der Compilation
  23. wird automatisch das Modul 'Debug' importiert und es wird spezieller Code
  24. erzeugt, damit die compilierten Module im Debugger angezeigt werden können.
  25. Außerdem erzeugt der Compiler Referenzdateien (mit der Endung '.ref'), die
  26. zusätzliche Informationen über die Module enthalten, und ohne die ODebug
  27. nicht arbeiten kann. Existiert im aktuellen Verzeichnis ein Unterverzeichnis
  28. mit dem Namen 'ref', werden die Referenzdateien dort gespeichert.
  29.  
  30. Nach der Compilation dieser Module muß das Programm noch wie ein normales
  31. Oberon-Programm mit OLink gelinkt werden.
  32.  
  33. Start vom CLI:
  34.  
  35. Vor dem Start von ODebug sollte die Größe des Stapelspeichers wie beim
  36. Compiler mit 'stack 20000' hochgesetzt werden. Der Debugger sollte vom
  37. CLI aus nur mit dem Befehl run gestartet werden, da man sonst, solange
  38. der Debugger aktiv ist, ein 'totes' CLI-Fenster übrig behält. Beim Start
  39. können, ähnlich wie beim Editor OEd, folgende Argumente übergeben werden:
  40.  
  41. Aufruf:
  42.  
  43. run ODebug {-{x#|y#|w#|h#|d#|s|l|p|r|c}}
  44.  
  45. Dabei steht das '#' für eine Dezimalzahl. Die Optionen haben folgende
  46. Bedeutung:
  47.  
  48. -x#, -y#  x- und y-Position der ODebug-Fenster
  49. -w#, -h#  Breite und Höhe der ODebug-Fenster
  50. -s        ODebug soll einen eigenen Screen öffnen
  51. -l        Screen soll im Interlace-Modus geöffnet werden
  52. -d#       Tiefe des ODebug-Screens, voreingestellt ist 2
  53. -p        'Popup Windows' deaktivieren
  54. -r        'Sort Records' aktivieren
  55. -c        'Close Pointers' aktivieren
  56.  
  57. Start von der Workbench:
  58.  
  59. Von der Workbench wird ODebug einfach durch einen Doppelklick auf sein
  60. Icon gestartet. Parameter können über sogenannte Tool Types angegeben
  61. werden. Diese können nach dem Anwählen des ODebug-Icons mit dem Menüpunkt
  62. 'Info' des Workbench-Menüs geändert werden können.
  63.  
  64. Folgende Tool Types können angegeben werden:
  65.  
  66. LEFTEDGE   x-Position der ODebug-Fenster
  67. TOPEDGE    y-Position der ODebug-Fenster
  68. WIDTH      Breite der ODebug-Fenster
  69. HEIGHT     Höhe der ODebug-Fenster
  70. SCREEN     Soll ein Screen geöffnet werden ('TRUE') oder nicht ('FALSE')
  71. INTERLACE  Screen im Interlace-Modus ('TRUE') oder im Non-
  72.            Inter-laced-Modus ('FALSE') öffnen
  73. DEPTH      Tiefe des ODebug-Screens
  74. POPUPWINDOWS
  75.            Option 'Popup Windows' setzen ('TRUE') oder löschen ('FALSE')
  76. SORTRECORDS
  77.            Option 'Sort Records' setzen ('TRUE') oder löschen ('FALSE')
  78. CLOSEPOINTERS
  79.            Option 'Close Pointers' setzen ('TRUE') oder löschen ('FALSE')
  80.  
  81. Die letzen drei Tool Types betreffen direkt die Voreinstellungen des
  82. Options-Menü, das weiter unten beschrieben wird.
  83.  
  84. Arbeitsweise von ODebug:
  85.  
  86. Nach demStart von ODebug wird ein schmales Fenster mit der Meldung 'Bitte
  87. mit Option '-g' compiliertes Programm starten!' geöffnet. Sie sollten nun
  88. also das zuvor compilierte und gelinkte Programm starten. Dabei können Sie
  89. es, je nach Belieben, von der Workbench oder vom CLI, mit oder ohne
  90. Parameter, starten. Der Debugger schließt daraufhin sein Fenster und
  91. öffnet für jedes Modul, das zuvor mit der Option '-g' compiliert wurde,
  92. ein Fenster, des den Quelltext dieses Moduls enthält. Die erste Anweisung,
  93. die Ihr Programm ausführen möchte, wird hervorgehoben dargestellt. Sie
  94. haben nun über das Menü des Debuggers volle Kontrolle über den Ablauf des
  95. Programms und können es schrittweise ablaufen lassen, oder auch über
  96. längere Programmteile 'rennen' lassen, bis von Ihnen vorgegebene
  97. Bedingungen erfüllt sind. Dies können an bestimmten Stellen im Programm
  98. gesetzte sogenannte Breakpoints sein, oder auch Variablen, die einen
  99. bestimmten Wert annehmen oder gar ein Laufzeitfehler.
  100.  
  101. Sollten Sie jetzt noch kein Programm debuggen wollen, können Sie den
  102. Debugger auch einfach durch Anklicken des Schließ-Gadgets wieder verlassen.
  103.  
  104. Die von ODebug geöffneten Fenster besitzen an ihren rechten und unteren
  105. Rändern Proportional- und Pfeil-Gadgets, mit denen man sich wie bei
  106. Workbench-Fenstern durch die angezeigten Informationen bewegen kann.
  107. Dies funktioniert bei allen Fenster von ODebug gleichermaßen.
  108.  
  109. Die Menüs:
  110.  
  111. Das Projekt Menü:
  112.  
  113. Abort Debug (Amiga + 'A'):
  114.  
  115.   Das Debuggen wird abgebrochen.
  116.  
  117. Quit (Amiga + 'Q'):
  118.  
  119.   Der Debugger wird verlassen.
  120.  
  121. About:
  122.  
  123.   Die Copyright-Meldung wird ausgegeben.
  124.  
  125.  
  126. Das Debug Menü:
  127.  
  128. Step (Amiga + 'S', Leertaste):
  129.  
  130.   Die nächste Anweisung wird ausgeführt.
  131.  
  132. Walk (Amiga + 'W'):
  133.  
  134.   Durch das Programm wird 'gelaufen'
  135.  
  136. Run (Amiga + 'R'):
  137.  
  138.   Das Debuggte Programm wird gestartet und Läuft bis zum nächsten BreakPoint
  139.   oder bis mit einer Maustaste abgebrochen wird.
  140.  
  141. Execute (Amiga + 'X'):
  142.  
  143.   Die aktuelle Anweisung wird ausgeführt.
  144.  
  145. Sprint (Amiga + 'T'):
  146.  
  147.   Das Programm wird gestartet. Es wird nur durch einen Laufzeitfehler
  148.   abgebrochen.
  149.  
  150. Show Statement (Amiga + 'H'):
  151.  
  152.   Die Aktuelle Anweisung wird angezeigt.
  153.  
  154. Das Breakpoint Menü:
  155.  
  156. Set (Amiga + 'T'):
  157.  
  158.   Ein Breakpoint wird auf die selektierte Anweisung gesetzt. Er wird danach
  159.   durch Fettschrift hervorgehoben.
  160.  
  161. Remove (Amiga + 'M'):
  162.  
  163.   Der selektierte Breakpoint wird entfernt.
  164.  
  165. Add Expression (Amiga + 'D'):
  166.  
  167.   Es kann ein Abbruchsausdruck angegeben werden. Das Programm bricht beim
  168.   Start mit Run ab, sobald der Ausdruck TRUE ist.
  169.  
  170. Change Expression (Amiga + 'J'):
  171.  
  172.   Hiermit können die Abbruchsausdrücke verändert werden.
  173.  
  174. Remove Expression (Amiga + 'O'):
  175.  
  176.   Hiermit können die Abbruchsausdrücke entfernt werden.
  177.  
  178. Clear All (Amiga + 'C'):
  179.  
  180.   Dieser Menüpunkt entfernt alle Breakpoints und Abbruchbedingungen.
  181.  
  182. Das Variables Menü:
  183.  
  184. Show (Amiga + 'V'):
  185.  
  186.   Zeigt die Variablen eines Sichtbarkeitsbereichs.
  187.  
  188. Extend (Amiga + 'E'):
  189.  
  190.   Erweitert das Record, das im aktuellen Variablenfenster gezeigt wird.
  191.  
  192. Change Value (Amiga + 'G'):
  193.  
  194.   Weist der selektierten Variablen einen neuen Wert zu.
  195.  
  196. Evaluate Expression (Amiga + 'U'):
  197.  
  198.   Berechnet einenen beliebigen Ausdruck.
  199.  
  200. Change Type (Amiga + 'Y'):
  201.  
  202.   Verändert den Typ, mit dem die selektierte Variable angezeigt wird.
  203.  
  204. Show active Procedures (Amiga + 'P'):
  205.  
  206.   Zeigt aktive Prozeduren.
  207.  
  208. Show called Procedures (Amiga + 'L'):
  209.  
  210.   Zeigt aufgerufene Prozeduren.
  211.  
  212. Save Contents:
  213.  
  214.   Speichert den Inhalt eines Variablenfensters.
  215.  
  216.  
  217.  
  218.  
  219.